/ Developer CD Series 1994 November: Tool Chest / Dev.CD Nov 94.toast / New System Software Extensions / OpenDoc A6 / OpenDoc Parts Framework / Documentation / Streams Component / Streams Component.rsrc / TOC#_1000

< prev

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 78 1e 46 69 67 75 72 | 65 20 30 15 31 20 49 6e |.x.Figur|e 0.1 In|
|00000010| 73 65 72 74 20 63 61 70 | 74 69 6f 6e 20 68 65 72 |sert cap|tion her|
|00000020| 65 1e 46 69 67 75 72 65 | 20 30 15 32 20 49 6e 73 |e.Figure| 0.2 Ins|
|00000030| 65 72 74 20 63 61 70 74 | 69 6f 6e 20 68 65 72 65 |ert capt|ion here|
|00000040| 0c 49 6e 74 72 6f 64 75 | 63 74 69 6f 6e 10 53 74 |.Introdu|ction.St|
|00000050| 72 65 61 6d 73 20 4f 76 | 65 72 76 69 65 77 09 44 |reams Ov|erview.D|
|00000060| 69 72 65 63 74 6f 72 79 | 08 48 65 72 69 74 61 67 |irectory|.Heritag|
|00000070| 65 1e 53 74 72 65 61 6d | 73 20 63 6f 6d 70 6f 6e |e.Stream|s compon|
|00000080| 65 6e 74 20 62 61 73 65 | 20 63 6c 61 73 73 65 73 |ent base| classes|
|00000090| 27 46 69 67 75 72 65 20 | 31 15 31 20 53 74 72 65 |'Figure |1.1 Stre|
|000000a0| 61 6d 73 20 63 6f 6d 70 | 6f 6e 65 6e 74 20 68 69 |ams comp|onent hi|
|000000b0| 65 72 61 72 63 68 79 2e | 1a 4f 74 68 65 72 20 63 |erarchy.|.Other c|
|000000c0| 6f 6d 70 6f 6e 65 6e 74 | 20 73 74 72 75 63 74 75 |omponent| structu|
|000000d0| 72 65 73 1a 53 74 72 65 | 61 6d 73 20 63 6f 6d 70 |res.Stre|ams comp|
|000000e0| 6f 6e 65 6e 74 20 63 6f | 6e 63 65 70 74 73 1b 53 |onent co|ncepts.S|
|000000f0| 74 72 65 61 6d 73 20 3c | 3c 20 61 6e 64 20 3e 3e |treams <|< and >>|
|00000100| 20 6f 70 65 72 61 74 6f | 72 73 1e 53 74 72 65 61 | operato|rs.Strea|
|00000110| 6d 73 20 61 73 20 6c 69 | 67 68 74 77 65 69 67 68 |ms as li|ghtweigh|
|00000120| 74 20 6f 62 6a 65 63 74 | 73 18 53 74 72 65 61 6d |t object|s.Stream|
|00000130| 73 20 63 6f 6d 70 6f 6e | 65 6e 74 20 64 65 73 69 |s compon|ent desi|
|00000140| 67 6e 0e 45 72 72 6f 72 | 20 68 61 6e 64 6c 69 6e |gn.Error| handlin|
|00000150| 67 2e 43 2b 2b 20 49 4f | 53 74 72 65 61 6d 73 20 |g.C++ IO|Streams |
|00000160| 43 6c 61 73 73 20 4c 69 | 62 72 61 72 79 20 76 65 |Class Li|brary ve|
|00000170| 72 73 75 73 20 4f 50 46 | 20 53 74 72 65 61 6d 73 |rsus OPF| Streams|
|00000180| 2f 44 65 63 69 64 69 6e | 67 20 62 65 74 77 65 65 |/Decidin|g betwee|
|00000190| 6e 20 43 2b 2b 20 49 4f | 53 74 72 65 61 6d 73 20 |n C++ IO|Streams |
|000001a0| 61 6e 64 20 4f 50 46 20 | 73 74 72 65 61 6d 73 20 |and OPF |streams |
|000001b0| 16 43 6f 6d 70 6f 6e 65 | 6e 74 20 64 65 70 65 6e |.Compone|nt depen|
|000001c0| 64 65 6e 63 69 65 73 13 | 52 65 6c 61 74 65 64 20 |dencies.|Related |
|000001d0| 63 6f 6d 70 6f 6e 65 6e | 74 73 3a 1b 55 73 69 6e |componen|ts:.Usin|
|000001e0| 67 20 74 68 65 20 53 74 | 72 65 61 6d 73 20 43 6f |g the St|reams Co|
|000001f0| 6d 70 6f 6e 65 6e 74 0f | 43 6f 64 69 6e 67 20 4f |mponent.|Coding O|
|00000200| 76 65 72 76 69 65 77 2a | 49 6e 73 74 61 6e 74 69 |verview*|Instanti|
|00000210| 61 74 69 6e 67 20 77 69 | 74 68 69 6e 20 74 68 65 |ating wi|thin the|
|00000220| 20 53 74 72 65 61 6d 73 | 20 63 6f 6d 70 6f 6e 65 | Streams| compone|
|00000230| 6e 74 28 53 75 62 63 6c | 61 73 73 69 6e 67 20 77 |nt(Subcl|assing w|
|00000240| 69 74 68 69 6e 20 74 68 | 65 20 53 74 72 65 61 6d |ithin th|e Stream|
|00000250| 73 20 63 6f 6d 70 6f 6e | 65 6e 74 1f 45 78 74 65 |s compon|ent.Exte|
|00000260| 6e 64 69 6e 67 20 74 68 | 65 20 53 74 72 65 61 6d |nding th|e Stream|
|00000270| 73 20 63 6f 6d 70 6f 6e | 65 6e 74 25 43 61 74 63 |s compon|ent%Catc|
|00000280| 68 69 6e 67 20 53 74 72 | 65 61 6d 73 20 63 6f 6d |hing Str|eams com|
|00000290| 70 6f 6e 65 6e 74 20 65 | 78 63 65 70 74 69 6f 6e |ponent e|xception|
|000002a0| 73 17 53 74 72 65 61 6d | 73 20 63 6f 6d 70 6f 6e |s.Stream|s compon|
|000002b0| 65 6e 74 20 74 61 73 6b | 73 2b 57 72 69 74 69 6e |ent task|s+Writin|
|000002c0| 67 20 64 61 74 61 20 75 | 73 69 6e 67 20 61 20 77 |g data u|sing a w|
|000002d0| 72 69 74 61 62 6c 65 20 | 73 74 72 65 61 6d 20 6f |ritable |stream o|
|000002e0| 62 6a 65 63 74 08 6f 76 | 65 72 76 69 65 77 4a 43 |bject.ov|erviewJC|
|000002f0| 72 65 61 74 69 6e 67 20 | 61 20 77 72 69 74 61 62 |reating |a writab|
|00000300| 6c 65 20 73 74 72 65 61 | 6d 20 66 72 6f 6d 20 61 |le strea|m from a|
|00000310| 20 73 69 6e 6b 20 74 68 | 61 74 20 72 65 70 72 65 | sink th|at repre|
|00000320| 73 65 6e 74 73 20 61 20 | 62 75 66 66 65 72 20 69 |sents a |buffer i|
|00000330| 6e 20 6d 65 6d 6f 72 79 | 2e 21 57 72 69 74 69 6e |n memory|.!Writin|
|00000340| 67 20 64 61 74 61 20 64 | 69 72 65 63 74 6c 79 20 |g data d|irectly |
|00000350| 74 6f 20 74 68 65 20 73 | 69 6e 6b 2a 52 65 61 64 |to the s|ink*Read|
|00000360| 69 6e 67 20 64 61 74 61 | 20 66 72 6f 6d 20 61 20 |ing data| from a |
|00000370| 72 65 61 64 61 62 6c 65 | 20 73 74 72 65 61 6d 20 |readable| stream |
|00000380| 6f 62 6a 65 63 74 08 4f | 76 65 72 76 69 65 77 23 |object.O|verview#|
|00000390| 52 65 61 64 69 6e 67 20 | 64 61 74 61 20 66 72 6f |Reading |data fro|
|000003a0| 6d 20 61 20 72 65 61 64 | 61 62 6c 65 20 73 74 72 |m a read|able str|
|000003b0| 65 61 6d 34 45 78 74 65 | 6e 64 69 6e 67 20 61 20 |eam4Exte|nding a |
|000003c0| 73 74 72 65 61 6d 20 74 | 6f 20 77 72 69 74 65 20 |stream t|o write |
|000003d0| 6f 62 6a 65 63 74 73 20 | 6f 66 20 79 6f 75 72 20 |objects |of your |
|000003e0| 6f 77 6e 20 74 79 70 65 | 14 46 57 5f 43 4d 65 6d |own type|.FW_CMem|
|000003f0| 6f 72 79 53 69 6e 6b 20 | 43 6c 61 73 73 0c 49 6e |orySink |Class.In|
|00000400| 74 72 6f 64 75 63 74 69 | 6f 6e 0b 48 65 61 64 65 |troducti|on.Heade|
|00000410| 72 20 46 69 6c 65 08 48 | 65 72 69 74 61 67 65 10 |r File.H|eritage.|
|00000420| 55 73 69 6e 67 20 54 68 | 69 73 20 43 6c 61 73 73 |Using Th|is Class|
|00000430| 1c 57 72 69 74 69 6e 67 | 20 74 6f 20 61 20 46 57 |.Writing| to a FW|
|00000440| 5f 43 4d 65 6d 6f 72 79 | 53 69 6e 6b 2e 13 52 65 |_CMemory|Sink..Re|
|00000450| 61 64 69 6e 67 20 46 72 | 6f 6d 20 61 20 53 69 6e |ading Fr|om a Sin|
|00000460| 6b 0f 52 65 6c 61 74 65 | 64 20 43 6c 61 73 73 65 |k.Relate|d Classe|
|00000470| 73 1a 53 75 62 63 6c 61 | 73 73 69 6e 67 20 46 57 |s.Subcla|ssing FW|
|00000480| 5f 43 4d 65 6d 6f 72 79 | 53 69 6e 6b 18 49 6e 73 |_CMemory|Sink.Ins|
|00000490| 74 61 6e 74 69 61 74 69 | 6e 67 20 74 68 69 73 20 |tantiati|ng this |
|000004a0| 63 6c 61 73 73 16 46 57 | 5f 43 4d 65 6d 6f 72 79 |class.FW|_CMemory|
|000004b0| 53 69 6e 6b 20 4d 65 74 | 68 6f 64 73 1a 46 57 5f |Sink Met|hods.FW_|
|000004c0| 43 52 61 6e 64 6f 6d 41 | 63 63 65 73 73 53 69 6e |CRandomA|ccessSin|
|000004d0| 6b 20 43 6c 61 73 73 0c | 49 6e 74 72 6f 64 75 63 |k Class.|Introduc|
|000004e0| 74 69 6f 6e 0b 48 65 61 | 64 65 72 20 46 69 6c 65 |tion.Hea|der File|
|000004f0| 08 48 65 72 69 74 61 67 | 65 1a 55 73 69 6e 67 20 |.Heritag|e.Using |
|00000500| 46 57 5f 43 52 61 6e 64 | 6f 6d 41 63 63 65 73 73 |FW_CRand|omAccess|
|00000510| 53 69 6e 6b 1f 46 57 5f | 43 52 61 6e 64 6f 6d 41 |Sink.FW_|CRandomA|
|00000520| 63 63 65 73 73 53 69 6e | 6b 20 73 75 62 63 6c 61 |ccessSin|k subcla|
|00000530| 73 73 65 73 0f 52 65 6c | 61 74 65 64 20 43 6c 61 |sses.Rel|ated Cla|
|00000540| 73 73 65 73 18 49 6e 73 | 74 61 6e 74 69 61 74 69 |sses.Ins|tantiati|
|00000550| 6e 67 20 74 68 69 73 20 | 63 6c 61 73 73 16 53 75 |ng this |class.Su|
|00000560| 62 63 6c 61 73 73 69 6e | 67 20 74 68 69 73 20 63 |bclassin|g this c|
|00000570| 6c 61 73 73 12 4f 76 65 | 72 72 69 64 69 6e 67 20 |lass.Ove|rriding |
|00000580| 4d 65 74 68 6f 64 73 1c | 46 57 5f 43 52 61 6e 64 |Methods.|FW_CRand|
|00000590| 6f 6d 41 63 63 65 73 73 | 53 69 6e 6b 20 4d 65 74 |omAccess|Sink Met|
|000005a0| 68 6f 64 73 18 46 57 5f | 43 52 65 61 64 61 62 6c |hods.FW_|CReadabl|
|000005b0| 65 53 74 72 65 61 6d 20 | 63 6c 61 73 73 0c 49 6e |eStream |class.In|
|000005c0| 74 72 6f 64 75 63 74 69 | 6f 6e 0b 48 65 61 64 65 |troducti|on.Heade|
|000005d0| 72 20 46 69 6c 65 08 48 | 65 72 69 74 61 67 65 10 |r File.H|eritage.|
|000005e0| 55 73 69 6e 67 20 54 68 | 69 73 20 43 6c 61 73 73 |Using Th|is Class|
|000005f0| 0f 52 65 6c 61 74 65 64 | 20 63 6c 61 73 73 65 73 |.Related| classes|
|00000600| 16 53 75 62 63 6c 61 73 | 73 69 6e 67 20 74 68 69 |.Subclas|sing thi|
|00000610| 73 20 63 6c 61 73 73 12 | 4f 76 65 72 72 69 64 69 |s class.|Overridi|
|00000620| 6e 67 20 6d 65 74 68 6f | 64 73 18 49 6e 73 74 61 |ng metho|ds.Insta|
|00000630| 6e 74 69 61 74 69 6e 67 | 20 74 68 69 73 20 63 6c |ntiating| this cl|
|00000640| 61 73 73 15 52 65 61 64 | 69 6e 67 20 64 6f 63 75 |ass.Read|ing docu|
|00000650| 6d 65 6e 74 20 64 61 74 | 61 17 52 65 61 64 69 6e |ment dat|a.Readin|
|00000660| 67 20 64 61 74 61 20 69 | 6e 20 67 65 6e 65 72 61 |g data i|n genera|
|00000670| 6c 1a 46 57 5f 43 52 65 | 61 64 61 62 6c 65 53 74 |l.FW_CRe|adableSt|
|00000680| 72 65 61 6d 20 4d 65 74 | 68 6f 64 73 21 46 57 5f |ream Met|hods!FW_|
|00000690| 43 52 65 61 64 61 62 6c | 65 53 74 72 65 61 6d 46 |CReadabl|eStreamF|
|000006a0| 6f 72 6d 61 74 74 65 72 | 20 43 6c 61 73 73 0c 49 |ormatter| Class.I|
|000006b0| 6e 74 72 6f 64 75 63 74 | 69 6f 6e 0b 48 65 61 64 |ntroduct|ion.Head|
|000006c0| 65 72 20 46 69 6c 65 08 | 48 65 72 69 74 61 67 65 |er File.|Heritage|
|000006d0| 10 55 73 69 6e 67 20 54 | 68 69 73 20 43 6c 61 73 |.Using T|his Clas|
|000006e0| 73 0f 52 65 6c 61 74 65 | 64 20 43 6c 61 73 73 65 |s.Relate|d Classe|
|000006f0| 73 12 4f 76 65 72 72 69 | 64 69 6e 67 20 4d 65 74 |s.Overri|ding Met|
|00000700| 68 6f 64 73 16 53 75 62 | 63 6c 61 73 73 69 6e 67 |hods.Sub|classing|
|00000710| 20 74 68 69 73 20 63 6c | 61 73 73 18 49 6e 73 74 | this cl|ass.Inst|
|00000720| 61 6e 74 69 61 74 69 6e | 67 20 74 68 69 73 20 63 |antiatin|g this c|
|00000730| 6c 61 73 73 23 46 57 5f | 43 52 65 61 64 61 62 6c |lass#FW_|CReadabl|
|00000740| 65 53 74 72 65 61 6d 46 | 6f 72 6d 61 74 74 65 72 |eStreamF|ormatter|
|00000750| 20 4d 65 74 68 6f 64 73 | 0e 46 57 5f 43 53 69 6e | Methods|.FW_CSin|
|00000760| 6b 20 43 6c 61 73 73 0c | 49 6e 74 72 6f 64 75 63 |k Class.|Introduc|
|00000770| 74 69 6f 6e 0b 48 65 61 | 64 65 72 20 46 69 6c 65 |tion.Hea|der File|
|00000780| 08 48 65 72 69 74 61 67 | 65 0e 55 73 69 6e 67 20 |.Heritag|e.Using |
|00000790| 46 57 5f 43 53 69 6e 6b | 17 42 75 69 6c 64 69 6e |FW_CSink|.Buildin|
|000007a0| 67 20 61 20 63 75 73 74 | 6f 6d 20 73 69 6e 6b 20 |g a cust|om sink |
|000007b0| 12 57 72 69 74 69 6e 67 | 20 74 6f 20 61 20 73 69 |.Writing| to a si|
|000007c0| 6e 6b 2e 13 52 65 61 64 | 69 6e 67 20 66 72 6f 6d |nk..Read|ing from|
|000007d0| 20 61 20 73 69 6e 6b 21 | 4d 61 6e 61 67 69 6e 67 | a sink!|Managing|
|000007e0| 20 72 61 6e 64 6f 6d 20 | 61 63 63 65 73 73 20 6f | random |access o|
|000007f0| 70 65 72 61 74 69 6f 6e | 73 0f 52 65 6c 61 74 65 |peration|s.Relate|
|00000800| 64 20 43 6c 61 73 73 65 | 73 14 53 75 62 63 6c 61 |d Classe|s.Subcla|
|00000810| 73 73 69 6e 67 20 46 57 | 5f 43 53 69 6e 6b 12 4f |ssing FW|_CSink.O|
|00000820| 76 65 72 72 69 64 69 6e | 67 20 6d 65 74 68 6f 64 |verridin|g method|
|00000830| 73 16 49 6e 73 74 61 6e | 74 69 61 74 69 6e 67 20 |s.Instan|tiating |
|00000840| 46 57 5f 43 53 69 6e 6b | 10 46 57 5f 43 53 69 6e |FW_CSink|.FW_CSin|
|00000850| 6b 20 4d 65 74 68 6f 64 | 73 1c 46 57 5f 43 53 77 |k Method|s.FW_CSw|
|00000860| 61 70 42 79 74 65 73 46 | 6f 72 6d 61 74 74 65 72 |apBytesF|ormatter|
|00000870| 20 43 6c 61 73 73 0c 49 | 6e 74 72 6f 64 75 63 74 | Class.I|ntroduct|
|00000880| 69 6f 6e 0b 48 65 61 64 | 65 72 20 46 69 6c 65 08 |ion.Head|er File.|
|00000890| 48 65 72 69 74 61 67 65 | 10 55 73 69 6e 67 20 54 |Heritage|.Using T|
|000008a0| 68 69 73 20 43 6c 61 73 | 73 0f 52 65 6c 61 74 65 |his Clas|s.Relate|
|000008b0| 64 20 43 6c 61 73 73 65 | 73 16 53 75 62 63 6c 61 |d Classe|s.Subcla|
|000008c0| 73 73 69 6e 67 20 74 68 | 69 73 20 63 6c 61 73 73 |ssing th|is class|
|000008d0| 12 4f 76 65 72 72 69 64 | 69 6e 67 20 4d 65 74 68 |.Overrid|ing Meth|
|000008e0| 6f 64 73 18 49 6e 73 74 | 61 6e 74 69 61 74 69 6e |ods.Inst|antiatin|
|000008f0| 67 20 74 68 69 73 20 63 | 6c 61 73 73 1e 46 57 5f |g this c|lass.FW_|
|00000900| 43 53 77 61 70 42 79 74 | 65 73 46 6f 72 6d 61 74 |CSwapByt|esFormat|
|00000910| 74 65 72 20 4d 65 74 68 | 6f 64 73 18 46 57 5f 43 |ter Meth|ods.FW_C|
|00000920| 57 72 69 74 61 62 6c 65 | 53 74 72 65 61 6d 20 63 |Writable|Stream c|
|00000930| 6c 61 73 73 0c 49 6e 74 | 72 6f 64 75 63 74 69 6f |lass.Int|roductio|
|00000940| 6e 0b 48 65 61 64 65 72 | 20 46 69 6c 65 08 48 65 |n.Header| File.He|
|00000950| 72 69 74 61 67 65 10 55 | 73 69 6e 67 20 54 68 69 |ritage.U|sing Thi|
|00000960| 73 20 43 6c 61 73 73 0f | 52 65 6c 61 74 65 64 20 |s Class.|Related |
|00000970| 43 6c 61 73 73 65 73 1e | 53 75 62 63 6c 61 73 73 |Classes.|Subclass|
|00000980| 69 6e 67 20 46 57 5f 43 | 57 72 69 74 61 62 6c 65 |ing FW_C|Writable|
|00000990| 53 74 72 65 61 6d 18 49 | 6e 73 74 61 6e 74 69 61 |Stream.I|nstantia|
|000009a0| 74 69 6e 67 20 74 68 69 | 73 20 63 6c 61 73 73 1a |ting thi|s class.|
|000009b0| 46 57 5f 43 57 72 69 74 | 61 62 6c 65 53 74 72 65 |FW_CWrit|ableStre|
|000009c0| 61 6d 20 4d 65 74 68 6f | 64 73 21 46 57 5f 43 57 |am Metho|ds!FW_CW|
|000009d0| 72 69 74 61 62 6c 65 53 | 74 72 65 61 6d 46 6f 72 |ritableS|treamFor|
|000009e0| 6d 61 74 74 65 72 20 43 | 6c 61 73 73 0c 49 6e 74 |matter C|lass.Int|
|000009f0| 72 6f 64 75 63 74 69 6f | 6e 0b 48 65 61 64 65 72 |roductio|n.Header|
|00000a00| 20 46 69 6c 65 08 48 65 | 72 69 74 61 67 65 10 55 | File.He|ritage.U|
|00000a10| 73 69 6e 67 20 54 68 69 | 73 20 43 6c 61 73 73 0f |sing Thi|s Class.|
|00000a20| 52 65 6c 61 74 65 64 20 | 43 6c 61 73 73 65 73 12 |Related |Classes.|
|00000a30| 4f 76 65 72 72 69 64 69 | 6e 67 20 4d 65 74 68 6f |Overridi|ng Metho|
|00000a40| 64 73 16 53 75 62 63 6c | 61 73 73 69 6e 67 20 74 |ds.Subcl|assing t|
|00000a50| 68 69 73 20 63 6c 61 73 | 73 18 49 6e 73 74 61 6e |his clas|s.Instan|
|00000a60| 74 69 61 74 69 6e 67 20 | 74 68 69 73 20 63 6c 61 |tiating |this cla|
|00000a70| 73 73 23 46 57 5f 43 57 | 72 69 74 61 62 6c 65 53 |ss#FW_CW|ritableS|
|00000a80| 74 72 65 61 6d 46 6f 72 | 6d 61 74 74 65 72 20 4d |treamFor|matter M|
|00000a90| 65 74 68 6f 64 73       |                         |ethods  |        |
+--------+-------------------------+-------------------------+--------+--------+